home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 001a / filesnip.zip / FILESNIP.DOC < prev    next >
Text File  |  1990-07-21  |  14KB  |  313 lines
  1. File-SNIP 1.2.1  The Downloader's friend.
  2. By Mad Monk Software
  3.  
  4.  
  5. Legal Notice:
  6. =============
  7.  
  8. Mad Monk Software is not responsible for any damages caused by
  9. the use  of or  inability to  use this  program.   Use of this
  10. program constitutes  your acceptance  of this  and  all  other
  11. provisions of this document.
  12.  
  13. SourceWare Notice:
  14. ==================
  15.  
  16. File-SNIP is  SourceWare, which means that you are free to try
  17. the program  to make sure it works for you before you register
  18. it, and  you get  source code  to better  understand  how  the
  19. program works  and/or modify  it to  properly suit your needs.
  20. This doesn't  mean that  you can try it for ever, as trying it
  21. in this case means that you use it ten (10) times or less.  If
  22. you find  yourself utilizing  this program more than 10 times,
  23. you are required to register your copy.
  24.  
  25.  
  26. Registration:
  27. =============
  28.  
  29. Registration is simple.  Print out the registration form which
  30. came in  this original  .ZIP packet (FILESNIP.REG).  Then fill
  31. in the blanks, enclose whatever you feel the program is worth,
  32. and send it to:
  33.  
  34. Mad Monk
  35. Software Division
  36. P.O. Box 90303
  37. San Diego, CA  92109.
  38.  
  39.  
  40. Program Background:
  41. ===================
  42.  
  43. File-SNIP came  about because  of my  desire  to  be  able  to
  44. download files  off of  BBSs and  keep track of what each file
  45. does by  copying the  description given on the BBS into a file
  46. that is then zipped into the file that I download.  As a sysop
  47. I utilize a program called SDI (Smart Directory Integrator (C)
  48. 1989 by  Robert B.  Browne and Smart Office Solutions.)  which
  49. extracts a  file called DESC.SDI from a zip packet and inserts
  50. the text  it into  a BBS file directory then moves the file to
  51. the uploaded  files directory.   This  means that  sysops  can
  52. receive  files   over  a   network  or  from  other  BBSs  and
  53. incorporate them into their own system without haveing to do a
  54. large amount  of work  to add  descriptions, move  files, etc.
  55. File-SNIP  will  help  sysops  because  after  the  sysop  has
  56. downloaded  files   from  other   BBSs,  s/he   can  copy  the
  57. FILENAME.RTT file that is created by File-SNIP (Where FILENAME
  58. is the  name of  the zipfile)  to DESC.SDI and zip it into the
  59. packet.   This is  especially easy  if the sysop has an editor
  60. with macro capabilities, as s/he can create a batch file to do
  61. all of the files at the same time.
  62.  
  63. As this  has  been  my  first  Assembly  program  for  the  PC
  64. (although I  did do  Assembly on an AT&T 3b2 which was a royal
  65. bitch), I am still working out alot of what I have learned.  I
  66. have started  work then  on a program which will work like SDI
  67. (described above) but utilize the FILENAME.RTT file.  Snip-ZIP
  68. as it will be called, will operate in two directions.  One, to
  69. zip the  .RTT files  into their  correct .ZIP  files,  and  if
  70. necessary create a ZIP file.  And two, to extract the contents
  71. of the  .RTT file  from within  the .ZIP  file and perform the
  72. same function  as SDI  from there.  I am presently taking care
  73. of my 9 month old baby full time, and have been unable to find
  74. ample time  when I  am fully  coherent.  (Hey all you guys out
  75. there, I never thought it was this tireing!)
  76.  
  77.  
  78. Compatability:
  79. ==============
  80.  
  81. File-SNIP  was   meant  to   be  used   with  Qmodem  4.x  and
  82. PCBoard/ProDoor.   It is  reported to  work with  ProComm  and
  83. ProComm Plus,  but I  have not  personally tested  it.  It may
  84. work with  other communications  and BBS programs as well.  If
  85. you use a communication program not listed here, and find that
  86. File-SNIP works, please let me know
  87.  
  88.  
  89. Starting and Using the Program:
  90. ===============================
  91.  
  92. To start  the program  with .RTT files being placed in current
  93. directory just  type "FILESNIP".   Otherwise start the program
  94. as follows:
  95. FILESNIP ROWS,COLS,/P=PATH  (ie.  filesnip 25,80,/P=d:\down)
  96.  
  97. It  is   recommended  that   you  utilize   the  MARK.COM  and
  98. RELEASE.COM programs  from TurboPower  Software with File-SNIP
  99. to allow you to remove it from memory when you don't need it.
  100.  
  101. A sample batch file of how to properly load File-SNIP and your
  102. communications program would be as follows:
  103.  
  104.      @ECHO OFF
  105.      MARK
  106.      FILESNIP 25,80,/P=D:\DOWNLOAD
  107.      CD \QMODEM
  108.      QMODEM
  109.      RELEASE
  110.  
  111.  
  112. Once in  your communications  program, call  a PCBoard/ProDoor
  113. BBS.   Look at a file directory.  When you see a file that you
  114. want to  download, hit  CTRL-~.  A block cursor will appear in
  115. the upper  left hand  cornerof the  screen if you haven't used
  116. the program previously durring the session.  You can then move
  117. the cursor  to the  beginning of the file description by using
  118. the  arrow   keys.     Hitting  the  INS  key  will  move  you
  119. automatically to the 34th column which is the default location
  120. for the  beginning of  file  descriptions  on  PCBoard/ProDoor
  121. BBSs.
  122.  
  123. When you  have reached  the beginning of the file description,
  124. hit  ENTER.     Then  move  the  cursor  to  the  end  of  the
  125. description, again  using the  arrow keys,  the END key or the
  126. HOME key.   As you move the cursor, the text between where you
  127. started and  the new cursor possition will become highlighted.
  128. When you  have highlighted  all the  text you want to capture,
  129. hit ENTER  again.   Then in  the top left hand corner you will
  130. get a  little menu  asking you  whether you  want to  send the
  131. description to  a  file,  the  printer,  or  ESCape  to  quit.
  132. Normally you  will want  to send the text to a file, so choose
  133. F.   The menu  will then be replaced with a prompt asking your
  134. for the filename to put the text in.  As long as the beginning
  135. point of  your highlighted  text is  on the  same line  as the
  136. FILENAME.EXT File-SNIP will automatically prompt you to put it
  137. in FILENAME.RTT.   If  you wish to use that filename, just hit
  138. return.  File-SNIP will then unhighlight the text and write it
  139. to  the  specified  file.    Then,  File-SNIP  will  spit  out
  140. FL FILENAME.EXT  so   that  the   file  will  be  flagged  for
  141. downloading.
  142.  
  143. If after  hitting the F to send the description to a file, you
  144. decide that  you don't  want to  flag the file and capture the
  145. text, just  hit ESC.  The FILENAME.RTT will disappear, leaving
  146. you at the beginning of the filename prompt entry point.  Just
  147. hit return,  without a  filename, and  you will be returned to
  148. perform other  functions on  the BBS  without File-SNIP  doing
  149. anything.
  150.  
  151. An example of how to use File-SNIP:
  152.  
  153. (1) hit CTRL-~
  154.  
  155. SKS-STRP.ZIP     3416  01-18-90  How to field strip and reassemble
  156.                                | a Soviet SKS or CHinese 56
  157.                                | semi-automatic rifle
  158.                                | Uploaded by: Skosch
  159.  
  160. (2)  move Hit INS key to move to 34th column.
  161. [(3) Move the cursor up or down to the line
  162.      where the file description you want to
  163.      download begins.]
  164.  
  165. SKS-STRP.ZIP     3416  01-18-90  How to field strip and reassemble
  166.                                | a Soviet SKS or CHinese 56
  167.                                | semi-automatic rifle
  168.                                | Uploaded by: Skosch
  169.  
  170. (4) Hit ENTER
  171. (5) Move  the cursor  to the end of the description by hitting
  172. the arrow  keys, the  HOME key and/or the END key.  (You don't
  173. really need  to get  the part  about who the file was uploaded
  174. by, or  any other  information that you don't need, unless you
  175. want it.)
  176.  
  177. SKS-STRP.ZIP     3416  01-18-90  How to field strip and reassemble
  178.                                | a Soviet SKS or CHinese 56
  179.                                | semi-automatic rifle  
  180.                                | Uploaded by: Skosch
  181. (6) Hit ENTER or "F"
  182. (7) If  you Hit  ENTER, you must then hit "F" to send to file.
  183. By hitting "F" at action #6, you save a keystroke.
  184.  
  185. Filename: SKS-STRP.RTT 
  186.  
  187. (8) Hit  ENTER or  enter a  new filename, or ESC then ENTER to
  188. cancel operation.   If  you hit ENTER, File-SNIP will flag the
  189. filename for you as follows.
  190.  
  191.  
  192. SKS-STRP.ZIP     3416  01-18-90  How to field strip and reassemble
  193.                                | a Soviet SKS or CHinese 56
  194.                                | semi-automatic rifle
  195.                                | Uploaded by: Skosch
  196. More?  (Y)es, (N)o, (F)lag, (NS) Non-Stop? FL SKS-STRP.ZIP
  197.  
  198.  
  199.  
  200. WARNINGS:
  201. =========
  202.  
  203. +    In  Qmodem, make  sure that  INT16 is not enabled in ATL-
  204. N/O/R/I.  In other communications programs, make sure that the
  205. expanded keyboard  is not  enabled.  Otherwise, File-SNIP will
  206. not flag files, although it will still capture the highlighted
  207. text to disk.
  208.  
  209. +   Send in your registration form as soon as possible.
  210.  
  211.  
  212.  
  213. Programming Information:
  214. ========================
  215.  
  216. File-SNIP has  been written  in Assembly  and compiled with by
  217. the Turbo  Assembler version  2.0 from  Borland International.
  218. It should work on most if not all IBM type computers.
  219.  
  220.  
  221. Program History:
  222. ================
  223.  
  224. This is a modification of the programme SNIPPER.
  225. 0.0.1     gets all chars on lines between point 1 and point 2
  226. 0.0.2     allows the  use of  HOME and END keys to move around
  227.           the screen.
  228. 0.0.3     allows  hitting  ESC  key  in  filename  prompt  for
  229.           entering completely new file name.
  230. 0.0.4     fixed bug  in ESC key during filename entry.  If esc
  231.           hit and  then return,  will exit  without saving  to
  232.           file.   if  ESC  hit  then  chars  entered  for  new
  233.           filename, will print to file.
  234. 0.0.5     added new  option when  writing to file.  Entering F
  235.           will now  strip out  all  multiple  spaces  and  any
  236.           pipes, as  well as  will  put  2  spaces  after  any
  237.           punctuation.  Old write to file (unformatted) is now
  238.           option "U"
  239. 0.0.6     fixed problem  with  help  box  not  displaying  all
  240.           options and correctly formatting the box.
  241. 0.0.7     fixed help  box display  so that it is uses it's own
  242.           character     attributes,  and   restores   original
  243.           attribute upon exit.
  244. 0.0.8     Added colour  to Help Box.  Unsure if will work with
  245.           mono
  246. 0.0.9     gets filename  from first 8 chars or from first char
  247.           to period,   of  first line  of highlight,  +  .RTT.
  248.           Refuses all chars which filenames can not contain.
  249. 0.1.0     checks  for  mono  display  adapter.    if  present,
  250.           displays mono help.
  251. 0.1.1     Modified display of copyright notice.
  252. 0.1.2     Added  use  of  INS  key  when  moving  to  top_left
  253.           position.   Hitting INS  will move the cursor to the
  254.           34th column,  which is  the standard  starting space
  255.           for file descriptions on PCB/ProDoor BBSs
  256. 0.1.3     Fixed problem  with getting  filename,  and  hitting
  257.           ESC.  Now resets filechar flag so that if used again
  258.           after hitting esc,  or entering a new filename, will
  259.           now find new filename.  Also, fills out full space     
  260.           for  filename   with   0H   after   each   filename.
  261.           Previously, if the new filename was shorter than the
  262.           last one entered, there would be residual chars.
  263. 0.1.4     Fixed problem with underscore as part of a filename.
  264.           Had accidently  included it in the list of chars not
  265.           acceptable.
  266. 0.1.5     Fixed highlighting  problem associated  with reading
  267.           filenames of 8 chars + ext.
  268. 0.1.6     Program sends  "fl filename.ext" to keyboard buffer,
  269.           for file flagging on BBS.
  270. 0.1.7     Pruned program  of unused  or unnecessary  functions
  271.           relating to SNIPPER
  272. 0.1.8     Extended total  filename size  to a  maximum  of  50
  273.           chars for large paths.
  274. 0.1.9     Fixed problem with using the program multiple times.
  275.           Wouldn't write  more than one file nor would it spit
  276.           out more then "F" on the second use in the file flag
  277.           section.
  278. 0.2.0     Reduced Maximum  filename length  to  12  places  in
  279.           anticipation of  the use  of a path statement on the
  280.           command line to be added in an upcomming version.
  281. 0.2.1     Added  use  of  pathname  on  command  line.    Path
  282.           statement will now be /P=path.  Command line must be
  283.           either  filesnip   by  itself   or   filesnip   with
  284.           rows,cols,/P=path following.
  285. 0.3.0     No modifications - Found no bugs
  286. 0.4.0     No modifications - Found no bugs
  287. 0.5.0     No modifications - Found no bugs
  288. 0.6.0     No modifications - Found no bugs
  289. 0.7.0     No modifications - Found no bugs
  290. 0.8.0     No modifications - Found no bugs
  291. 0.9.0     No modifications - Found no bugs
  292. 1.0.0     Initial Release - 6 June 1990
  293. 1.0.1     Made use of path statement flag on command line non-
  294.           case sensitive.
  295. 1.0.2     Added ESC  before flagging  of file  to download  in
  296.           case user is in scrollback mode.  Not Released.
  297. 1.1.0     Added reformatting  of captured text to make it look
  298.           better in  the .RTT  file.   Now, no  line  will  be
  299.           longer than  72 chars,  with text  broken at spaces.
  300.           Not Released.
  301. 1.1.1     Added breaking  of lines  at all appropriate places,
  302.           ie: hyphens,  slashes, underscores,  plus and  equal
  303.           symbols.   Also fixed  bug which occured if for some
  304.           unknown reason  a captured  line had  more  than  72
  305.           chars in a row (ie. no white spaces).  Not Released.
  306. 1.2.0     Removed Printer  feature as  it  was  more  or  less
  307.           useless.  Not Released.
  308. 1.2.1     Removed the  extra carriage  return which was beeing
  309.           added to  the .RTT  file.  It was giving me problems
  310.           with the  program used to incorporate files into the
  311.           BBS.
  312.  
  313.